home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / dis.z / dis
Encoding:
Text File  |  2002-10-03  |  5.6 KB  |  129 lines
  1. DIS(1)                                                 Last changed: 1-4-99
  2.  
  3.  
  4. NNAAMMEE
  5.      ddiiss - Disassemble an object file
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ddiiss [ _o_p_t_i_o_n_s ] _f_i_l_e
  9.  
  10. IIMMPPLLEEMMEENNTTAATTIIOONN
  11.      IRIX systems
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      ddiiss disassembles object files into machine instructions.  The
  15.      following options are accepted:
  16.  
  17.      --bb _b_e_g_i_n_a_d_d_r_e_s_s
  18.               Disassemble starting at the given address.  The address can
  19.               be in decimal, octal (with a leading 0), or hexadecimal (with
  20.               a leading 0x).
  21.  
  22.      --dd ""_s_e_c_t_i_o_n""
  23.               Disassemble the named section as data, printing the offset
  24.               from the beginning of the section.
  25.  
  26.      --CC       Demangle C++ names.
  27.  
  28.      --DD _s_e_c_t_i_o_n
  29.               Disassemble the named section as data, printing the actual
  30.               address of the data.
  31.  
  32.      --ee _e_n_d_a_d_d_r_e_s_s
  33.               Disassembly stops at the given address.  The address can be
  34.               in decimal, octal (with a leading 0), or hexadecimal (with a
  35.               leading 0x).
  36.  
  37.      --FF _f_u_n_c_t_i_o_n
  38.               Disassemble the named function only in each object file
  39.               specified on the command line.  This option may be specified
  40.               multiple times on the command line.
  41.  
  42.      --ff       Prefixes the line number on disassembly lines with the source
  43.               file basename.
  44.  
  45.      --hh       Substitute the general register names for the software
  46.               register names in the output.
  47.  
  48.      --HH       Remove the leading source line, leaving hex value and the
  49.               instructions.
  50.  
  51.      --ii       Remove the leading source line and hexadecimal value of
  52.               disassembly, leaving only the instructions.
  53.  
  54.      --II _d_i_r_e_c_t_o_r_y
  55.               Use the _d_i_r_e_c_t_o_r_y to help find the source code.
  56.  
  57.      --ll _s_t_r_i_n_g
  58.               Disassemble the archive file specified by _s_t_r_i_n_g.  For
  59.               example, ddiiss --ll xx would add uussrr//lliibb//lliibbxx..aa to the files to be
  60.               disassembled.
  61.  
  62.      --LL       Look up source labels for subsequent printing.  This option
  63.               works only if the file was compiled with debugging
  64.               information.
  65.  
  66.      --oo       Print addresses and contents in octal.  The default is
  67.               hexadecimal.
  68.  
  69.      --pp ""_f_u_n_c_t_i_o_n""
  70.               The same meaning as --FF _f_u_n_c_t_i_o_n
  71.  
  72.      --ppiixxiiee   For ppiixxiiee(1)d files, display original and pixified
  73.               instructions intermixed with source.  This is the default
  74.               with pixified files, so this option obsolete and will
  75.               eventually be removed.
  76.  
  77.      --ss       Attempts to print jj, jjaall target names.  Not very relevant
  78.               since with PIC code jj, jjaall are little used.  This is the
  79.               default unless the --ssvvrr44 option is specified.
  80.  
  81.      --ssvvrr44    Print using svr4 output format.  This means (if no other
  82.               options given) no externals are named (when loading data off
  83.               of the $gp register).
  84.  
  85.      --SS       Display source code intermixed with the assembly code.  There
  86.               is no guarantee that the source code displayed is the source
  87.               code used to compile the function, since ddiiss simply looks for
  88.               a source file starting with name/path given in the object and
  89.               continuing by looking in directories specified with --II (if
  90.               any) and accepts the first appropriately-named file it finds
  91.               as the source file.  If --SS is repeated on the command line
  92.               ddiiss will, in addition, name the source file involved (with
  93.               whatever path was used to acess the file), as in the example
  94.               "SSkkiippppiinngg ssoouurrccee lliissttiinngg ttoo lliinnee 1100 ooff //bb//tt..cc......".
  95.  
  96.      --TT       Trace flag is for debugging of the disassembler itself.
  97.  
  98.      --tt _s_e_c_t_i_o_n
  99.               Disassemble the named section as a text section.
  100.  
  101.      --vv       Attempts to print the names of inlined functions where the
  102.               function is inlined.  The information about inlines is not
  103.               always present in the debug information, so this option will
  104.               not always produce the inlined function names.
  105.  
  106.      --VV       Print the version of ddiiss being executed.
  107.  
  108.      --ww       Attempts to print source information (names of user variables
  109.               involved) after (to the right of) assembly codes.  This
  110.               option  comes into effect only if --ss is also specified, but
  111.               does not imply --ss.  (But recall from above that --ss is on by
  112.               default unless --ssvvrr44 is specified, so --ww is effective by
  113.               itself unless --ssvvrr44 was specified.)
  114.  
  115.      --xx       Prints offsets and constants in instructions as hex numbers.
  116.               The default is to print instruction offsets and constants as
  117.               decimal.
  118.  
  119.      If the --dd, --DD or --tt options are specified, only those named sections
  120.      from each user-supplied filename will be disassembled.  Otherwise, all
  121.      sections containing text will be disassembled.
  122.  
  123. FFIILLEESS
  124.      //uussrr//bbiinn//ddiiss
  125.  
  126. SSEEEE AALLSSOO
  127.      This man page is available only online.
  128.  
  129.